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Chroma Computer Interface Manual Introduction 


INTRODUCTION 


This section should serve as an overview of the Chroma computer interface and 
of the topics that will be covered in detail in the subsequent sections of 
this manual. 


Purpose of the interface -- The Chroma computer interface is to allow the 
Chroma or Chroma Polaris to be controlled by a computer. A Chroma can be 
controlled by another Chroma, but this is not the main intent of the inter- 
face. 


Capabilities of the interface -- The interface allows a number of different 
functions to be performed. 


A computer can "play" the Chroma's keyboard and performance controls. 


A computer can record what a human plays on the keyboard and performance 
controls. 


A computer can change sounds, or modify parameters in existing sounds. 


A computer can record the changes made to a sound by a human manipulating 
the panel controls of the Chroma. 


A computer can load or save packets of information using the cassette 
interface on the Chroma. 


A computer can temporarily alter the workings of the Chroma by changing 
the firmware of the Chroma'ts internal computer. This facility is not 
likely to be very useful to anyone outside Rhodes, but may be used in 
future products designed to enhance the Chroma. 


Physical nature of the interface -- The computer interface consists of two 
identical 8-bit parallel ports, one for each direction. Each port consists of 
8 latched data bits, a status line that tells whether there is information on 
the port, and an acknowledge line which is pulsed whenever a data byte is read 
from the port. All signals are TTL compatible, which means that interface 
hardware is simple and cheap. However, this also means that the interface is 
not designed to work over great distances or in the presence of ground differ- 
ences or large amounts of noise. Each device must have a set/reset flip-flop 
driving the status line for its output port. This flip-flop must be set when 
writing a byte to the port and cleared by the acknowledge pulse received from 
the other end. The acknowledge pulse will normally be the read pulse used to 
read the data from the port. 


Interface protocol -- Communication in each direction is independent of com- 
munication in the other direction. The interface is best handled in an inter- 
rupt driven environment with a queue (first-in first-out list) for buffering 
the information in each direction (or at least in the input direction). There 
are two levels to the protocol, the physical and the logical. The physical 
level is kept simple by the fact that each byte transferred is acknowleged by 
the receiving end before another byte may be transferred. The logical level 
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can be more complex because a communication that requests a response from the 
other end doesn't necessarily receive the response immediately. In fact, 
several different requests may be transmitted before the responses start 
coming back. 


Command language -- All communication issued by a computer to control a Chroma 
is in the form of commands. A command is a sequence of one or more bytes, 
where the first byte is the command code (similar to a machine language op- 
code) and the remaining bytes are operands. For instance, the command to set 
parameter 5 in program 9 to a value of 3 consists of the sequence 7, 9, 5 and 
3. (7 is the command code for Write Parameter.) Certain commands require a 
response from the Chroma. In this case, the Chroma will respond by sending 
back what looks like a command that begins with the same command code. It 
isn't really a command, as the Chroma doesn't control the computer, but it 
takes a similar form. There are also commands to the Chroma that enable 
recording from the Chroma. When these commands are issued, the Chroma enters 
a mode in which it will send "commands" to the computer whenever a note is 
played or a control is moved. Ina simple recording system, these commands 
may be played back verbatim at a later time. Thus, even though the Chroma 
doesn't actually tell the computer what to do, the communication in both 
directions is organized as commands. 


The interface view of the Chroma -- The performer sitting at the Chroma "sees" 
a system that is capable of generating two sounds at a time using the Link 
capability. The computer connected to the Chroma "sees" a system that is 
capable of generating up to eight different sounds at a time using the "multi- 
ple instrument" capability. The reason that the performer isn't given this 
capability from the keyboard is that there is no easy and reliable way for a 
performer to "tell" the Chroma which notes go with which sounds, beyond a 
simple keyboard split. The computer interface doesn't have this limitation, 
as it can instruct the Chroma which sound to use with each note. The inter- 
face is designed to allow the performer to play one "track" at a time (or two, 
using a link) into a computer, and then the computer to play multiple "tracks" 
back as if there were multiple instruments being played. 


The interface view of the Expander -- A Chroma Expander looks just like a 
Chroma through the computer interface, except that it is not capable of gener- 
ating keyboard information. It should be used for playback only. 


The interface view of the Polaris -- A Polaris looks just like a Chroma, 
through the interface, except for the following differences: 


The Polaris has a different set of parameters and a different number of 
programs. 


The Polaris has no latch footswitch or effects pedal. 


When a computer is recording from the Polaris, the Polaris can generate 
three streams of notes. The first two come from the keyboard, as in the 
Chroma, and the third comes from the Polaris' internal sequencer. 


The Polaris only has six voices. Even so, eight sounds can be set up at 
one time. The Polaris, unlike the Chroma, dynamically allocates voices to 
the different sounds as notes are played. 
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In the Polaris, each program may or may not exist. In the Chroma, all 
programs always exist. 


The Polaris has some additional interface commands that allow access to 
sequence objects as well as program objects. 


The Polaris doesn't support a few of the commands understood by the 
Chroma. 
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CHROMA STRUCTURE 


The intent of this section is to describe the way the Chroma appears through 
the computer interface, and to relate the way a computer deals with the Chroma 
to the way a human performer or programmer deals with the Chroma. A computer 
has a much greater range of control over the instrument than a human, as it is 
capable of communicating with it much faster than a human could ever punch 
buttons, What a human sees of the Chroma's inner workings is a subset of what 
the computer sees, and it is important to understand both in order to fully 
exploit the capabilities of the interface. 


The Human's View -- A person sitting at the Chroma and manipulating the con- 
trols on the Chroma's panel has a certain view of the inner workings of the 
Chroma. This view has the following characteristics: 


There are fifty programs in the Chroma's memory that can be called upon at 
any time, numbered 1 through 50. 


There is a fifty-first program (program 0) that controls the sound of the 
instrument. 


Selecting a program causes one of the fifty stored programs to be copied 
into program 0, and storing a program causes program 0 to be copied into 
one of the fifty storage locations. 


All creating and editing of programs is done to program 0, and then stored 
someplace else. 


A second sound, called a link, can be added to the main sound. The link 
sound is controlled by the link program, which is one of the fifty stored 
programs. A parameter in program 0 "points to" the link program. 


Certain other parameters in program 0 affect the link. These include the 
Keyboard Split, Link Mode (lower, unison or upper), Transposes and the 
Link Balance, 


Since the link is one of the fifty stored sounds, it cannot be directly 
edited. 


Changing a parameter from the panel causes program 0 to be modified, and 
the sound reflects this change. The original program from which program 0 
was copied is not affected. 


The performance controls affect both the main and link sounds. The notes 
played on the keyboard are assigned to the main and/or link sounds accord- 
ing to the link mode and keyboard split. 


The Computer's View -- A computer "looking into" the computer interface port 
on the Chroma has a much more detailed view of the inner workings of the 
Chroma than a person sitting at the controls. The most important concept that 
must be understood when working with the computer interface is the concept of 
an "instrument", In a physical sense, the Chroma itself is obviously an 
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instrument. Here, though, we are concerned with a more symbolic interpreta- 
tion of the word. In this sense, the Chroma is capable of containing more 
than one "instrument" as it is capable of generating more than one sound at a 
time. To understand this, study the following definitions: 


Channel -- A channel is the basic unit of sound generation, consisting of 
an oscillator, wave shaper, filter, amplifier, glide, sweep and two envel- 
opes (if patch 0 is selected), or consisting of two oscillators, wave 
shapers, filters, amplifiers, glides and sweeps, and four envelopes (if 
patch 1-15 is selected). 


Board -- A board is the physical entity containing the synthesizer cir- 
cuitry. A board contains two channels if patch 0 is selected, or one 
channel if patch 1-15 is selected. If patch 0 is selected, the two halves 
of the board will always have the same sound characteristics. The Chroma 
has eight boards. 


Program -- A program is a set of parameters that completely defines a 
sound, plus a few parameters that represent settings of certain panel 
controls (such as the edit mode and link information). The battery backup 
memory in the Chroma contains 51 programs. 


-- An instrument is a group of boards that is treated as a 
logical entity, and whose sound is defined by a particular program. There 
can be as many as eight instruments defined in the Chroma at any one time, 
numbered 0 through 7. Each instrument has its own set of performance 
control and keyboard "inputs" that function independently of the inputs to 
other instruments. 


The notion of an instrument makes sense if you consider the Chroma as a small 
ensemble. Through the computer interface one might play a piece of music 
involving a guitar, a bass, and two trumpets. This would be done by defining 
four instruments by sending the appropriate Define commands to the Chroma, and 
then sending commands to attack and release notes to the individual instru- 
ments within the Chroma. The two trumpet instruments would presumably be 
defined by the same program, emphasizing the fact that a program and an 
instrument are two different animals. 
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Translating The Human's View To The Computer's View -- When controlling the 
Chroma from its control panel and keyboard, two sounds can be played at a 
time. Internally this means that, you guessed it, two instruments can be 
defined. The various actions that can be performed from the panel translate 
into internal manipulations of programs and instruments as follows: 


Program Select Without Link -- The selected program is copied into program 
0. Then instrument 0 is defined according to program 0 and instrument 1 


is undefined, 


Select With Link -- The selected program is copied into program 0. 
Then instrument 0 is defined according to program 0 and instrument 1 is 
defined according to the link progran. 


Link -- Instrument 0 is left unchanged and instrument 1 is defined accord- 
ing to the specified link program. The Link Mode and Link Program para- 
meters in program 0 are set accordingly. 


Unlink -- Pressing [NO LINK] twice causes the link to be cleared by unde- 
fining instrument 1. The Link Mode parameter in program 0 is set to "No 
Link", 


"No Link" Program Select -- Pressing [NO LINK] followed by a numbered 
switch causes the selected program to be copied into program 0, except 
that the link related parameters are not copied. Instrument 0 is then 
defined according to program 0 and instrument 1 is left alone. 


Information -- When a key is pressed and no link is in effect, 
the key number is transposed according to the Main Transpose parameter in 
program 0 and sent to instrument 0. If a link is in effect, the key 
number is sent to instrument 0 and/or 1, depending upon the Link Mode and 
Keyboard Split parameters in program 0. Information sent to instrument 1 
is transposed according to the Link Transpose parameter in program 0. All 
key press information that is sent to either instrument is recorded, along 
with its transposition, ina key list. When a key is released, it is 
looked up in the key list and the transposition recorded there is sent to 
the appropriate instrument(s). Thus, the Chroma won't be confused by 
changing transpositions or keyboard splits while keys are held down. 


Pressure Sensor Information -- If the Pressure Sensor option is installed, 
varying the pressure on any key causes the appropriate information to be 
sent to instrument 0 and/or instrument 1, depending upon the key's entry 
in the key list. That is, if the note's attack was sent to an instrument, 
subseqent pressure information will also be sent there. 


Performance Control Information -- When a lever, pedal or footswitch is 
moved, the appropriate information is sent to instrument 0 and, if a link 
is in effect, to instrument 1. 


Parameter Changes -- Changing any of the numbered parameters causes the 
appropriate values in program 0 to be altered. Whenever a program is 
altered in any way, any instruments defined by that program are automatic- 
ally affected. Changing any of the panel parameters does not directly 
affect any instruments, although it may, as in the case of the Link Mode 
parameter, indirectly affect either instrument 0 or 1. 


2-3 


Chroma Computer Interface Manual Chroma Structure 


Thus, the panel controls manipulate instruments 0 and 1, using instrument 0 
for the main sound and instrument 1 for the link sound. Instruments 2 through 
7 are not affected, and are always undefined when the instrument is first 
turned on. 


Board Allocation and Channel Assignment -- Board allocation is the process of 
deciding which boards are assigned to which instruments. This process is 
repeated any time an instrument is defined or undefined. Channel assignment 
is the process of deciding which channels are assigned to which notes. This 
process occurs dynamically as notes are played and released. These two pro-= 
cesses are separate, yet they do affect each other: 


The channel assignment is controlled by the Keyboard Algorithm parameter, 
which determines whether the instrument is polyphonic (using multiple 
channels) or monophonic (using a single channel). This choice affects 
board allocation in that a monophonic instrument is never assigned more 
than one board. 


The channel assignment is independent for each instrument and must use 
only those channels assigned to that instrument by the board allocation 
process. Defining or undefining an instrument (or changing between a mono 
and a poly keyboard algorithm) affects the number of boards available to 
other instruments and, as such, impacts the channel assignment of other 
instruments. Undefining an instrument generally makes channels available 
to other instruments, while defining an instrument usually robs channels 
from other instruments. 


The board allocation process operates by first calculating how many boards 
should be allocated to each instrument and then boards are taken from instru- 
ments that have too many and given to instruments that have too few. Unaf- 
fected boards can continue to generate sound during this process. In addi- 
tion, the board robbing is intelligent enough to favor boards that are not 
currently sounding. Calculating the number of boards each instrument should 
have is done in a round-robin manner, like dealing cards. The rules are: 


The number of boards in the system is usually eight, but may be smaller if 
the autotune detected a bad board. 


An undefined instrument doesn't get any boards. 


An instrument whose Keyboard Algorithm parameter is 5 or more is con- 
sidered monophonic, and is assigned a maximum of one board. (If patch 0 
is selected, only one of the two channels will be used.) 


An instrument whose Keyboard Algorithm parameter is 4 or less is con- 
sidered polyphonic, and may be assigned any number of boards. (If patch 0 
is selected, there are twice as many channels available as there are 
boards.) 


The dealing of boards to instruments continues until all boards are used 


up, or until all instruments have been checked and none of them are 
polyphonic. In the latter case, there may be boards left over. 
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Temporary Parameter Changes ~-- When a performer selects a program and then 
alters a parameter, this change is recorded in program 0 but not in the 
original stored program. Although program 0 is in fact stored in the same 
battery-backup memory as the other fifty programs, it is, by conventional 
usage, a temporary program. During performance, one may modify a parameter in 
a program, but this change is usually not stored. Therefore, every time the 
same program is selected, the changes made last time it was selected are 
usually not still there. 


The intent of the computer interface is to allow several "performances" to be 
recorded separately and then played back simultaneously. Since there is only 
one "program 0", another means is provided for making temporary changes to the 
several sounds that may be selected at once. Whenever an instrument is 
defined according to a particular program, a translation occurs. The informa- 
tion that makes up a program is very different from the information recorded 
for each instrument. A program consists of 59 bytes in which all the para- 
meters are packed as tightly as possible to conserve memory. An instrument is 
represented by a couple hundred bytes of information in which the parameters 
are expanded into a form that allows for fast processing. There are separate 
commands for changing parameters in a program and changing parameters in an 
instrument. The Write Parameter command is used to alter the value of any 
parameter in any program, and its effect is permanent. If any instrument 
happens to be defined by that program, it will be affected too. The Set 
Parameter command, however, only alters the translation of the parameter in 
the instrument and doesn't affect the program that defines the instrument. If 
the Set Parameter command is used to alter parameters, these changes will be 
temporary and will not show up again the next time an instrument is defined by 
the same program. Note also that, while the Write Parameter command has a 
complementary Read Parameter command, the Set Parameter command has no 
complement. 


Instrument Definition Parameters -- Whenever an instrument is defined through 
the computer interface, the performance control inputs must be initialized. 
To this end, the Define command includes operands that represent the positions 
of the levers, pedals and footswitches. There is also a volume operand that 
acts as a master volume control. The volume is also controllable separately 
through the use of the Volume command. An instrument's volume is only acces- 
sible from the panel through the use of the link balance control. 


When recording from the Chroma, the computer will receive Define, Undefine and 
Volume commands from the Chroma whenever programs are selected, linked or 
unlinked. The performance control operands in the Define commands will re- 
flect the true physical position of the performance controls at that time. 
The Link Balance and Link Mode parameter determines the volumes of the instru- 
ments as follows: 


If no link is in effect, instrument 0 will be defined with a volume of 255 
(maximum). 


If a link is in effect, instruments 0 and 1 will be defined with volumes 
determined by the Link Balance parameter. 


When a link is cleared, in addition to sending an Undefine command for 


instrument 1, the Chroma will send a Volume command for instrument 0 
reflecting the fact that its volume is now 255. 
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When a link is set up, in addition to sending a Define command for instru- 
ment 1, the Chroma will send a Volume command for instrument 0 reflecting 
the setting of the Link Balance. 


When the Link Balance parameter is changed, volume commands will be sent 
by the Chroma for both instruments 0 and1ifalinkisineffect. If no 
link exists, no volume commands will be sent. 


It should be clear by now that most of the communication with the Chroma is 
actually communication with individual instruments within the Chroma. The 
command set, listed in the next section, shows this. Some commands (like Read 
and Write Parameter, mentioned earlier) aren't associated with an instrument, 
but most of the commands involved in recording and playing back music are 
addressed to individual instruments within the Chroma. 


2-6 


Chroma Computer Interface Manual Polaris Structure 


POLARIS STRUCTURE 


The intent of this section is to describe the way the Polaris appears through 
the computer interface, and to relate the way a computer deals with the 
Polaris to the way a human performer or programmer deals with the Polaris. A 
computer has a much greater range of control over the instrument than a human, 
as it is capable of communicating with it much faster than a human could ever 
punch buttons. What a human sees of the Polaris' inner workings is a subset 
of what the computer sees, and it is important to understand both in order to 
fully exploit the capabilities of the interface. 


The Human's View -- A person sitting at the Polaris and manipulating the con- 
trols on the Chroma's panel has a certain view of the inner workings of the 
Chroma. This view has the following characteristics: 


There are up to 132 programs in the Polaris' memory that can be called 
upon at any time, numbered A1, A2, ... K12. Each one can either exist or 
not exist. 


There are up to 3 logical instruments within the Polaris that can be used 
to play music with different sounds. Two, the Main Instrument and the 
Link Instrument, are playable from the keyboard. The third, the Sequencer 
Instrument, is playable by the sequencer, The Main Instrument always 
exists, and the other two may or may not exist. 


Each instrument that exists contains a copy of a program that determines 
its sound. The 132 programs stored in memory do not directly control the 
sound of anything. 


Selecting a program causes one of the 132 stored programs to be copied 
into the Main Instrument, and storing a program causes the program within 
the Main Instrument to be copied into one of the 132 storage locations, 


All creating and editing of programs is done to a copy while it is held in 
a logical instrument, and then stored someplace else. The program in any 
logical instrument can be edited. 


The performance controls affect both the main and link sounds. The 
notes played on the keyboard are assigned to the main and/or link 
sounds according to the link mode and keyboard split. 


Polaris vs. Chroma -- The Chroma uses the terms "board" and "channel" to refer 
to the sound generation circuitry. The Polaris uses a single term, "voice", 
to refer to the sound generation circuitry. Unlike a "board", which can be 
split into two "channels", a "voice" cannot be split. 


The boards in the Chroma are allocated to logical instruments as the instru- 
ments are defined. Boards can, therefore, be though of as being parts of 
the instruments. In the Polaris, voices are allocated dynamically among the 
instruments as notes are played. Voices, then, must be thought of as separate 
entities that are used by instruments, not parts of instruments. 
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The Computer's View -- A computer "looking into" the computer interface port 
on the Polaris has a much more detailed view of the inner workings of the 
Polaris than a person sitting at the controls: 


Instruments -- The Polaris can contain up to eight logical instruments, 
The Main, Link and Sequencer instruments are numbered 0, 1 and 2 through 
the interface. Although they do not necessarily exist, RAM is reserved 
for them so that they can always be created if they do not exist. 
Instruments 3 through 7, however, do not exist until created through the 
interface. Since RAM is not reserved for them, there is a chance that the 
creation will fail if the Polaris' memory is too full. 


Objects -- The inside of the Polaris consists of a number of software 
"objects" that can be accessed through the interface. There are the 132 
program objects, the eight instrument objects and the twelve sequence 
objects. The computer can create, open, read, write and delete objects in 
a manner similar to the way disk files are accessed. 


Translating The Human‘'s View To The Computer's View -- When controlling the 
Polaris from its control panel and keyboard, three sounds can be played at a 
time. The actions of setting up a link or a keyboard split work just like 
they do in the Chroma with the following exceptions: 


Panel Parameters -- The Link Mode and Link Program Number parameters only 
take effect when a program is selected from the panel. Using the 
interface to set the Link Mode in the Main Instrument does not cause the 
link. to be changed. 


Performance Control Initialization -- When a program is selected from the 
panel, the Main (and possibly Link) Instrument is defined, and their 
performance control inputs are initialized as follows: 


The volume input is initialized to its nominal value of 255, as the 
Polaris does not have a volume performance control. (The Volume 
parameter in a Polaris program is not a performance control.) 


The pedal input is initialized according to the Pedal Initial 
parameter in the program. (This parameter is the pedal setting that 
was in effect when the program was stored.) The physical position of 
the pedal is ignored. 


The lever and footswitch values are initialized to zero. Then, if the 
actual controls are not in their zero states, additional commands set 
the control inputs to the correct values. 


Pressure Information -- The Polaris never generates pressure information 
(unless its sequencer recorded pressure information received over the 
interface). If Pressure commands are received, however, they are applied 
to the Pedal input to each voice. That is, the Pedal related parameters 
determine how pressure will affect the sound. (If Pedal and Pressure 
commands are used together, they will fight with each other.) 


Parameter Changes -- The sequencer can generate parameter changes on the 


Sequencer Instrument. In addition, the programming controls can be temp- 
orarily connected to the Link or Sequencer Instrument, allowing parameter 
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changes to be generated manually for all three predefined instruments. 


Temporary Parameter Changes -- When a performer selects a program and then 
alters a parameter, this change is recorded in the Main Instrument, but not in 
the original stored program. Therefore, every time the same program is sel- 
ected, the changes made last time it was selected are usually not still there. 
If the computer interface is used to play back several concurrent tracks, each 
containing parameter changes, each track will play on a separate logical 
instrument, and each logical instrument contain its own copy of a progran. 
Thus, parameter changes sent to one instrument will not affect any other 
instrument, even if they were defined by the same program. 


Performance Inputs -- Whenever an instrument is defined through the computer 
interface, the performance control inputs must be initialized. To this end, 
the Define command includes operands that represent the positions of the 
levers, pedal and footswitch. There is also a volume operand that acts as a 
master volume control. The volume is also controllable separately through the 
use of the Volume command. An instrument's volume is not accessible from the 
panel. 


Unlike the Chroma, when the Polaris generates a Define command, it does not 
use the lever, pedal and footswitch operands of the Define command. Rather, 
it sets these to zero, and then, if the physical levers and footswitch are not 
in their zero positions, additional commands are generated. As mentioned 
before, the instrument automatically sets its own pedal input according to the 
Pedal Initial parameter. Therefore, the physical pedal position is completely 
ignored when an instrument is defined, and no Pedal command ever follows the 
Define command. 


When playing the Polaris through the interface, the computer may use the 
operands in the Define command to initialize the performance inputs, or it may 
do as the Polaris itself does and follow the Define command with additional 
commands that set the performance inputs. The pedal input to the instrument 
may be initialized in three ways, though: 


If the Define command is followed by a Pedal command, the Pedal command 
will of course take effect. 


If the Define command is not followed by a Pedal command, but contains a 
non-zero pedal operand, that operand will take effect. 


If the Define command is not followed by a Pedal command and contains a 
zero pedal operand, the Pedal Initial parameter initializes the pedal. 


Therefore, data recorded from the Polaris can be played back verbatim, and 
sound the same as when it was recorded. The Pedal Initial parameter allows 
the playback to function properly even if the recording was made with the 
pedal all the way back but the playback sound requires that the pedal be all 
the way forward. 
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The 


COMMAND DESCRIPTIONS 


computer that is connected to the Chroma or Chroma Polaris via the inter- 


face cable communicates with it by sending and receiving commands. A command 
consists of: 


A byte that specifies the command. If the command applies to one of the 
eight logical instruments, the instrument number is encoded in this byte, 
too. 


Zero or more bytes that specify parameters of the command. Although most 
commands require specific numbers of parameters, a few commands are vari- 
able in length. 


Certain conventions are adhered to in the command language: 


The 


Undefined commands are considered to be No Operation commands; that is, 
undefined commands are ignored. All No Operation command have no para- 
meters. 


Command code zero and command code FF (hex) will always be No Operation 
commands, even for future instruments that utilize this interface. 


Command code 1 will allways be an Identification command, for these and 
any other instruments utilizing this interface. 


If a two-byte quantity (such as a memory address) is to be transferred, it 
is sent most significant byte first, just the way you would write it on 
paper. 


If a command is variable in length, one of the operands specifies the 
variable number of data bytes. This is not the same as the length of the 
command, as the count does not include the command code, the length byte, 
or any other fixed parameters for the command. The Peek command is a good 
example of this. 


If a command is variable in length, the length byte of the command speci- 
fies the length as follows: values 1 to 255 represent byte counts of 1 to 
255, and a value of zero represents a byte count of 256. 


commands fall roughly into three categories, according to protocol: 


There are commands that are issued by the computer and require no response 
from the instrument. 


There are those commands that are issued by the computer and require a 
specific response from the Chroma. The response is always a command 
starting with the same code that was received from the controlling device. 
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There are those commands that establish modes within the instrument that 
allow the Chroma to subsequently transmit unsolicited commands when cer-=- 
tain events occur. The unsolicited commands generally look like commands 
from the first group above. 


The command set can also be split into two categories, according to destin- 
ation: 


There are those commands that are addressed to the Chroma or Polaris as a 
whole. The lower command codes are assigned to these commands. 


There are those commands that are addressed to individual logical instru- 
ments. The higher command codes are assigned to these commands. The 
three least significant bits of these command codes hold the instrument 
number. 


What follows is a complete description of each command, along with the numer- 
ical code (in hexadecimal) for each command byte. 


No Operation 00 
The only significance of this particular No Operation (as opposed to any 
of the undefined command codes) is that the Chroma sends this code upon 
power-up or reset. The Polaris doesn't. 

Identification 01 
The instrument responds with three bytes, an Identification command, a 


device code (1 for a Chroma, 2 for a Chroma Expander, 3 for a Polaris), 
and a software revision level code (see Appendix A). 


Read Program 02 pp 
The Chroma responds by transmitting program number pp. The information is 
transmitted as a Read Program command and 59 data bytes. (If pp is not 
between 0 and 50, the data bytes are undefined.) 


The Polaris supports this for compatibility, although the Open Object and 
Peek commands are more versatile. The differences are: 


If pp is zero, the contents of the Main Instrument is resturned. 


If pp is not between 1 and 132, or if the program does not exist, a 
complete scratch program is returned. 


The 44-byte program that is returned is padded with 15 zero bytes. 
Write Program 03 pp dd... dd 
The 59 data bytes dd... dd are written into program number pp in the 
Chroma. (If pp is not between 0 and 50, the data is accepted and ig- 


nored. ) 


The Polaris supports this for compatibility, although the Open Object, 
Create Object and Poke commands are more versatile. The differences are: 


yn2 
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If pp is zero, the Main Instrument is defined according to the new 
program. 


If pp is not between 1 and 132, the data is accepted and ignored. 
If program pp does not exist, it is created. 
Load Packet 04 


In the Chroma, one packet of information is read from the cassette inter- 
face, its error detection codes are checked, and the result is returned 
via the interface in the form: 
O4 nn dd... dd 

nn specifies the number of data bytes in the packet, and the dd bytes are 
the contents of the packet. The first byte of the packet (the first dd 
byte) is always the packet ID, which identifies the type of packet. The 
packet ID for valid data is always non-zero. If an error occurs in the 
reading of the cassette, a special error packet with an ID of 0 is re- 
turned. 


This command starts reading from the cassette immediately. This can cause 
a problem if the cassette was previously idle. See the Tape Space command 
below. 


The types of packets that are currently defined, and the forms the Chroma 
return them in, include: 


Error Packet 04 02 00 nn 
The length is 2, the ID is 0, and nn is 0 if a read error is detected 
or FF hex if the cassette was not running (or was shut off in mid- 
operation). 


Packet O4 3C 01 dd... dd 
The length is 60 (3C hex), the ID is 1, and the 59 bytes of data 
represent a Chroma program. 


Number Packet 04 02 02 nn 
The length is 2, the ID is 2, and the single byte of data consists of 
a valid program number (0 to 50). This type of packet appears, with a 
program number of 1, at the beginning of a tape recorded with SAVE 
ALL. 


Stop Packet 04 01 03 
The length is 1, the ID is 3, and there is no data in the packet. 
This type of packet appears at the end of a tape recorded with SAVE 
ALL. 


The Polaris does not support this command. 
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Save Packet 05 nn dd... dd 


In the Chroma, the packet dd... dd containing nn bytes is written to the 
cassette. The first dd byte, which is the packet ID must be non-zero. 
The Chroma responds when the operation is complete with 05 00 if the 
operation completes normally or 05 FF if the cassette isn't running. 


This command must not be sent to the Polaris, as it does not support it. 
Read Parameter 06 pp nn 


Parameter number nn in program number pp is read and returned in the form 
06 vv, where vv is the parameter value. If pp or vv is out of range for 
the instrument, the returned value is undefined. In the Polaris, a pp 
value of zero refers to the Main Instrument. 


Write Parameter 07 pp nn vv 


Parameter number nn in program number pp is set to value vv. If pp is out 
of range for the instrument, the vv value is ignored. If vv is out of 
range for the parameter, the result is undefined, except that the para- 
meter is never set to an illegal value. 


Panel Switch Off 08 


The "panel switch" referred to is the software switch which "connects" the 
programming controls to the interface. When the instrument receives this, 
it echoes it and disconnects the panel from the interface. 


Panel Switch On 09 


When the instrument receives this, it echoes it and connects the panel to 
the interface. While this mode is in effect, the instrument transmits 
certain commands when the following events occur: 


Whenever a program is selected, a Define command is transmitted for 
instrument 0 (the Main Instrument) and either a Define or an Undefine 
command is transmitted for instrument 1 (the Link Instrument), depend- 
ing upon the existence of a link. 


Whenever a parameter is changed, a Set Parameter command is transmit- 
ted for instrument 0 in the Chroma. In the Polaris, the panel may be 
connected to the Main, Link or Sequencer Instrument, so a Set Para-~ 
meter command may be transmitted for instrument 0, 1 or 2. 


Whenever the link balance is varied in the Chroma, Volume commands are 
transmitted for instruments 0 and 1. 


Whenever the Polaris sequencer plays a sequence, a Define is transmit- 
ted for instrument 2 (the Sequencer Instrument) at the start of the 
sequence, and an Undefine is transmitted at the end of the sequence. 
If the sequence contains parameter changes, Set Parameter commands are 
also transmitted. 
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Note -- In the Polaris, the Performance Switch 
(described below) must also be on if panel infor- 
mation is to be transmitted. 


Performance Switch Off OA 


The "performance switch" referred to is the software switch that "con- 
nects" the various performance controls to the interface. When the in- 
strument receives this command, it echoes it and disconnects the perfor- 
mance controls from the interface. 


In the Polaris, the performance switch is really just a composite of the 
three Chroma Output switches accessible as Lower Function B 4, 5 and 6. 
The Performance Switch Off command simply turns off all three of these. 
This means that in the Polaris, the performance switch gates everything, 
ineluding panel information. 


Performance Switch On OB 


When the instrument receives this, it echoes it and connects the per- 
formance controls to the interface. While this mode is in effect, the 
instrument transmits certain commands when the following events occur: 


Whenever a key is pressed on the keyboard, an Attack command is trans- 
mitted for instrument 0, 1 or both, depending upon the link mode and 
keyboard split. 


Whenever a key is released on the keyboard, a Release command is 
transmitted for instrument 0, 1 or both, depending upon the link mode 
and whether or not an attack had already been sent for the note. 


Whenever a lever, pedal or footswitch moves, the appropriate command 
is transmitted for instrument 0, and for instrument 1 if a link is in 
effect. 


When the Polaris sequencer is used, commands are transmitted for 
instrument 2. 


In the Polaris, the performance switch is really just a composite of the 
three Chroma Output switches accessible as Lower Function B 4, 5 and 6. 
The Performance Switch Onf command simply turns on all three of these, 


Peek OC aa aa nn 


The Chroma responds by transmitting nn bytes from its internal memory 
starting at location aaaa. The response is in the form: 

OC nn dd... dd 
where the dd bytes are data bytes from ascending addresses, 


The Polaris responds by transmitting nn bytes from whatever object is 
currently open. If the object does not exist, or if bytes are requested 
from beyond the end of the object, zeros are returned. 
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Peek Two Bytes OD aa aa 


The Chroma responds by transmitting two bytes from its internal memory at 
locations aaaa and aaaa+1. The response is in the form: 

OD dd dd ; 
This command is guaranteed to extract the two bytes concurrently, with no 
chance that the memory locations could be altered between the transmittal 
of each byte. 


The Polaris responds by transmitting two bytes from the currently open 
object at locations aaaa+1 and aaaa. The reversed order is due to the 
fact that the Polaris' computer stores LSBs before MSBs. If the open 
object does not exist, or if bytes are requested from beyond the end of 
the object, zeros are returned. 


Poke OE aa aa nn dd... dd 


In the Chroma, the nn data bytes dd... dd are poked into its address 
space starting at location aaaa. If an Unlock command has not been issued 
since the Chroma was powered up (or reset), the entire command is read in 
and ignored. 


In the Polaris, the data bytes are poked into the currently open object if 
it is write enabled. If the object was not opened with writing enabled, 
or if the object does not exist, the entire command is read in and ig- 
nored. Bytes written beyond the end of the object are also ignored. 


Poke Two Bytes OF aa aa dd dd 


Tap 


In the Chroma, two data bytes dd dd are poked into the computer's address 
space in locations aaaa and aaaa+1, respectively. If an Unlock command 
has not been issued since the Chroma was powered up (or reset), the entire 
command is read in and ignored. This command is guaranteed to poke the 
two bytes concurrently, without danger of the computer utilizing half of 
the old contents and half of the new contents. 


In the Polaris, the two data bytes are poked into the currently open 
object in locations aaaa+1 and aaaa, respectively. If the object was not 
opened with writing enabled, or if the object does not exist, the entire 
command is read in and ignored. Bytes written beyond the end of the 
object are also ignored. 


Panel 10 


The Chroma's panel tapper is triggered, unless it has been disabled. The 
Polaris ignored this. 


Unlock 11 00 FF 


This sequence must be transmitted in order to enable the Poke and Poke Two 
Bytes commands in the Chroma. If the operand bytes are anything except 00 
and FF, the Poke and Poke Two Bytes commands are subsequently disabled. 
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Tape Space 12 


The cassette motor is run for two seconds. Upon completion, the Chroma 
responds with 12 00 if the cassette was running, or 12 FF if it was shut 
off. 


The purpose of this command is to allow startup time before other cassette 
operations, If a sequence of Save Packet commands are to be issued, they 
should be preceded by two Tape Space commands. In addition, if the pack- 
ets are to be individually readable, they should be separated by two Tape 
Space commands. A single Tape Space command should be issued prior to a 
sequence of Load Packet commands. 


The Polaris ignores this, and does not return any response. 
Restore 13 


The Chroma or Polaris is restored to the state reflected by its panel 
settings. All instruments are undefined except instrument 0 and possibly 
1, which are set up according to the currently selected program. The 
panel switch, performance switch and pressure switch are turned off, and a 
Panel Switch Off, Performance Switch Off and Pressure Switch Off command 
are echoed, in that order. (See Appendix A for information on early 
revisions. ) 


Pressure Switch Off 14 
The "pressure switch" referred to is the software switch that "connects" 
the keyboard pressure sensors to the interface. When the Chroma receives 
this command, it echoes it and disconnects the pressure sensors from the 
interface. This command is not implemented in early Chromas. See Appen- 
dix A. 
The Polaris does not implement a pressure switch, but does echo this. 
Pressure Switch On 15 
When the Chroma receives this, it echoes it and connect the pressure 
sensors to the interface. While this mode is in effect, the Chroma sends 
Pressure commands for instrument 0 and/or 1 whenever the pressure on a key 
is varied. See Appendix A. 
The Polaris does not implement a pressure switch, but does echo this. 


Tune Get 16 


The Polaris responds with 16 tt, where tt is the setting of the Master 
Tune control. The value is a signed byte scaled in 128ths of a semitone. 


The Chroma ignores this and does not return a response. 
Tune Set 17 tt 


The Polaris' Master Tune control is set to tt. The value is a signed byte 
scaled in 128ths of a semitone. 
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This must not be sent to a Chroma, as it does not support it. 

Open Object 18 oo oo mm 
The Polaris selects object ooo00 as the open object, and returns a response 
in the form: 

18 nn nn 

where nnnn is the number of bytes in the object. The mm operand is the 
open mode. If this is odd, the object is write enabled. If this is even, 
the object is write protected. 
Object oooo need not exist when this is called. If it does not exist, the 
returned length is zero. If it is subsequently created, it will still be 
open, 
This must not be sent to the Chroma, as it does not support it. 

Create Object 19 oooo nnnn mm 
The Polaris creates object oooo with a length nnnn and a mode of mm. The 
object is not opened. In fact, this may be issued while a different 
object is open. The mm parameter should be zero. 


If the object already exists, or if there isn't enough memory, this is 
ignored. The result of this can be found by using Open Object. 


This must not be sent to the Chroma, as it does not support it. 
Delete Object 1A 
Ths Polaris deletes the open object if it exists and is write-enabled. 
The Chroma ignores this. 
Add Extension 1B 


The currently open object is added to the list of software extensions in 
the Polaris. This will crash the Polaris. 


The Chroma ignores this. 
Send Message 1C ss nn mm 00 


The Polaris inserts message mm and operand oo into internal data stream 
ss. If the message requires an instrument number, it is provided by nn. 


This must not be sent to the Chroma, as it does not support it. 
Get LED 1D nn 
The Polaris returns the state of LED nn in the form 
1D ss 


where ss is 01 if the LED is on or 00 if it is off. If the LED is 
blinking, this has a 50/50 chance of returning either. 
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Pressure 68+i kk pp 


Instrument i is told to set the key pressure input for note kk to value 
pp. The pressure is an unsigned number from 0 to 63. 


This command is transmitted for instrument 0 and/or 1 by the Chroma if the 
pressure switch is on and the measured pressure on a depressed key 
changes. Pressure commands only occur between the corresponding Attack 
and Release commands for the same note, 


This command is not implemented in early Chromas, and must not be sent to 
them. Current Chromas responds correctly to this command even if the 
Pressure Sensor option is not installed. See Appendix A. 


The Polaris applies pressure values to the pedal input on each voice. The 
Polaris only generates Pressure commands if its sequencer was used to 
record incoming Pressure commands. Since the Polaris has no pressure 
switch, such sequencer=generated commands are gated only by the Perform- 
ance Switch. 


Information T0+i 


The Chroma responds by echoing the command and sending four information 
bytes. Currently, only the first byte is utilized, and contains the 
number of channel boards assigned to instrument i. The other three bytes 
are zero. The Polaris always returns a voice count of 6 in the first 
operand byte, even if fewer voices are allocated to the instrument, as 
this is the maximum number of notes that can be played on any logical 
instrument. 


Volume 78+i vv 


The volume of instrument i is set to vv. The value vv is a linear control 
from 0 to 255, and is nominally 255. Thus, to reduce the volume of an 
instrument 6db, the correct vv value would be 128. 


This command is transmitted (for instruments 0 and 1) by the Chroma if the 
panel switch is on and the Link Balance parameter is varied. This is 
never sent by the Polaris unless its sequencer recorded incoming volume 


commands. 
Lever 1 80+i vv 
Lever 2 88+i vv 


The lever input on instrument i is set to vv, where vv is a signed 2's 
complement byte in the range -128 to +127. This range corresponds to the 
mechanical range from "pull" to "push", with O corresponding to "at rest". 


These commands are transmitted (for instruments 0 and possibly 1) if the 


performance switch is on and the performer moves a lever. They may also 
be transmitted by the Polaris sequencer for instrument 2. 
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Pedal 1 90+i vv 
Pedal 2 98+i vv 


The pedal input on instrument i is set to vv, where vv is a number in the 
range 0 to 255. This range corresponds to the mechanical range from 
"heel" to "toe", 


These commands are transmitted (for instruments 0 and possibly 1) if the 
performance switch is on and the performer moves a pedal. The Pedal 1 
command may also be transmitted by the Polaris sequencer for instrument 2. 


The Polaris has no pedal 2. If it receives a Pedal 2 command, it accepts 
it and ignores it. 


Footswitch 1 Down AO+i 
Footswitch 1 Up A8+i 
Footswitch 2 Down BO+i 
Footswitch 2 Up B8+i 


These commands activate or deactivate the footswitch functions on instru- 
ment i. Footswitch 1 is the right, or sustain, footswitch. Footswitch 2 
is the left, or effects, footswitch. 


These commands are transmitted (for instruments 0 and possibly 1) if the 
performance switch is on and the performer presses or releases either 
footswitch. The Footswitch 1 commands may also be transmitte by the 
Polaris sequencer for instrument 2. 
The Polaris has no Footswitch 2. 

Define CO+i pp aa bb ce dd ee ff 


Instrument i is defined according to program pp. The remaining bytes 
specify initial values for the performance inputs: 


aa: lever 1 bb: lever 2 
ce: pedal 1 dd: pedal 2 
ee; volume ff; footswitches 


The footswitch byte uses the most significant bit to represent footswitch 
1 and the next most significant bit to represent footswitch 2. A 0 means 
up, 1 means down. 


In the Chroma, if pp is not between 0 and 50, the instrument is defined 
according to program 0. Boards are reallocated as fairly as possible 
among defined instruments. If this command requires that one or more 
channel boards be robbed from another instrument, the computer is kind 
enough to try and pick boards that aren't currently sounding. 


In the Polaris, if pp is not between 0 and 132, or if the program does not 
exist, a scratch sound results. Program 0 refers to the program in the 
Main Instrument. Also, voices are not allocated to the instrument until 
notes are played. 


The Polaris ignores the pedal 2 operand and the second footswitch bit. In 


addition, if the pedal 1 operand is zero, the pedal input is initialized 
according to the Pedal Initial program. 
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This command is transmitted for instrument 0 (and possibly 1) if the panel 
switch is on and the performer selects a program or a link. This command 
is transmitted for instrument 2 by the Polaris at the beginning of a 
sequence, or whenever the program is changed within a sequence. 


Undefine C8+i 


Instrument i is removed from operation. In the Chroma, any channel boards 
or assigned to instrument i are redistributed among any other instruments. 
In the Polaris, any voices assigned to instrument i are deallocated, and 
are allocated to other instruments when further notes are played. 


This command is transmitted for instrument 1 if the panel switch is on and 
an unlinked program is selected while a link is in effect, or a link is 
cleared. This command is transmitted for instrument 2 by the Polaris at 
the end of a sequence. 


Attack DO+i kk vv pp 


Instrument i is told to attack note kk with a velocity vv and an initial 
pressure pp. The key number is a signed, 2's complement byte that must be 
in the range -64 to +63. The Chroma's keyboard has a range from -32 to 
+32, with 0 being middle C, and can be transposed up or down an octave for 
a total range of -44 to +44. The Polaris' keyboard has a range from -36 
to +24 and can be transposed up an octave for a total range of -32 to +36. 


In the Chroma the velocity must be a number from 0 (softest strike) to 31 
(hardest strike), and the pressure must be a number from 0 (no pressure) 
to 63 (full pressure). The excess high bits are ignored. The result of 
this command depends upon the keyboard algorithm parameter in the program 
that the instrument is defined by. 


In the Polaris, the velocity must also be a number from 0 to 31, but bit 5 
of the vv byte has a special meaning. When set (that is, when 32 is added 
to the velocity), the attack is monophonic, meaning that it is directed to 
the most recently used voice for the instrument and not the least recently 
used voice. 


This command is transmitted for instrument 0 and/or 1 if the performance 
switch is on and the performer presses a key. It may also be transmitted 
by the Polaris sequencer for instrument 2. 


Early Chromas transmit a pressure byte that is always zero, and ignore the 
received pressure byte. Current Chromas respond to pressure information 
received even if the Pressure Sensor option is not installed. 


Release D8+i kk vv 


Instrument i is told to release note kk with a velocity vv. In the 
Chroma, the result of this command depends upon the keyboard algorithm 
parameter in the program that the instrument is defined by. In the Polar- 
is, all voices assigned to the note are released. 
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This command is transmitted for instrument 0 and/or 1 if the performance 
switch is on and the performer releases a key. It may also be transmitted 
by the Polaris sequencer for instrument 2. 


Set Parameter E0+i nn vv 


Instrument i sets parameter nn to value vv. This does not affect the 
setting stored in the program originally used to define the instrument, 
which means that it won't affect other instruments defined according to 
the same program and it won't affect this instrument if it is redefined 
according to the same program. 


In the Chroma, this may not be used to set panel parameters. In the 
Polaris, this may be used to set panel parameters, although certain panel 
parameters (the Link Mode and Link Program Number have no effect when set 
in this manner. 


If nn is out of range for the instrument, the command is accepted and 
ignored. If vv is not within the valid range for the selected parameter, 
the only guarantee is that the parameter will not be set to an illegal 
value. 


This command is transmitted for instrument 0 if the panel switch is on and 
the performer varies one of the parameters, It may also be transmitted by 
the Polaris sequencer for instrument 2. 


Status | E8+i 


This command causes the instrument to respond with: 
E8+i pp aa bb ce dd ee ff 

where the seven parameters represent the same quantities as the parameters 
of the Define command. If the instrument is undefined, the program number 
returned is FF and the remaining are be undefined. If the program number 
is 0, the Chroma returns the program number in the display, and the 
Polaris returns the program number that the Main Instrument was originally 
defined by. 


Squelch FO+i kk 


Any channels in instrument i that are assigned to key k are squelched by 
setting their envelopes to 0. This doesn't affect the channel assignment 
tables. Even latched channels may be squelched. If kk is -128 (80 hex) 
all channels are squelched. 


In the Polaris, the kk value is ignored, and all voices are squelched. 
The Polaris also transmits this at the end of a sequence for instrument 2 
in place of an Undefine if the performance switch is on but the panel 
switch is off. 
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SOFTWARE REQUIREMENTS 


Levels of Complexity -- The complexity of the software needed to communicate 
with the Chroma is dependent upon the kind of communication desired. The most 
important factor is whether or not the software can wait for input from the 
Chroma. A simple system can be designed in which all communication is essen- 
tially half-duplex, meaning that when the computer is expecting information 
from the Chroma it is doing nothing else. This precludes recording and play- 
ing concurrently. In fact, it precludes doing much more with information 
arriving from the Chroma than storing it for later processing. 


In order to allow more processing to occur in response to information arriving 
from the Chroma (as opposed to processing that is totally independent of what 
the Chroma might be sending), it is advisable to make the input system inter- 
rupt driven. This would allow information to be taken into the computer as 
soon as the Chroma sends it, where it would be queued until it could be 
processed. 


If it is desired to record and process information from the Chroma while doing 
a large amount of unrelated processing (such as communicating with other 
instruments or a display terminal), some form of multi-tasking is necessary. 
A generalized multi-tasking operating system would be nice, but hardly neces- 
sary. The Chroma firmware is itself structured as two concurrent tasks, as 
the Chroma has plenty of stuff to do besides wait around for commands to 
arrive on the interface. 


If it is important that outputting information to the Chroma be fast, a queue 
can be provided for outgoing information, and an interrupt can be used to move 
bytes from the queue onto the port. This is also done in the Chroma. 


A Simple System -- The simplest form of communication doesn't require any 
fancy software support. It is only necessary to wait for the output port to 
be empty before outputting each byte, and wait for the input port to be full 
before inputting each byte. BASIC peeks and pokes are sufficient for handling 
programming information, although most interpreted versions of BASIC aren't 
really fast enough to implement a decent sequencer. Note also that it would 
be advisable to include some method of getting out of the loop that waits for 
input from the Chroma (such as pressing a key on the computer terminal) to 
prevent communications problems from hanging the computer. A loop witha 
timeout might be appropriate when the computer requests specific information 
from the Chroma. Unless the Chroma is doing an autotune or cassette oper- 
ation, it should respond to any command within a couple milliseconds. 


A Sytem With Interrupt Driven Input -- This kind of system is what most people 
will probably be interested in playing with. The Hardware Requirements sec- 
tion of this manual shows an interface circuit that includes provisions for 
interrupting the processor when either the input port is full or the output 
port is empty. The output interrupt is less important, so the gates needed 
for this can be left out if not desired. The purpose behind making the input 
interrupt driven is that it keeps the real-time constraints of the Chroma from 
extending into the bulk of the computer software. This is because it allows 
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rapid bursts of information from the Chroma to be handled as long as the 
computer can keep up with the average rate of information flow. The software 
necessary to do interrupt driven input consists of three procedures. The 
initialization procedure sets up the queue pointers and enables the interrupt. 
The interrupt handler pulls bytes off the port and stuffs them in the queue. 
The input procedure pulls bytes out of the queue for processing. These algor- 
ithms are presented below. Note that the interrupt handler must be written so 
that it returns with the interrupt masked in the event that the queue is full, 
and the input routine must, upon removing a byte from the queue, reenable the 
interrupt. 


INTERRUPT DRIVEN INPUT ALGORITHM 
PROCEDURE TO INITIALIZE INTERFACE -- called upon start-up 


set head and tail queue pointers to zero 
unmask input interrupt 


INTERRUPT HANDLER 


input byte into tail of queue 
advance queue tail pointer 
if input queue full 

mask input interrupt 


INPUT PROCEDURE 


wait for queue to be not empty 
remove byte from head of queue 
advance queue head pointer 
unmask input interrupt 

return byte 


A fourth procedure might be provided to check to see if anything is in the 
queue without actually waiting in a loop. 


A Fully Interrupt Driven Dual Task System -- This is really a description of 
the way the Chroma handles its end of the interface. The algorithms described 
below show how the interface software might be written to allow inputting 
information to be handled as a separate parallel task, without the use of a 
multi-tasking operating system. The purpose of multi-tasking is to allow a 
computer to take turns doing more than one thing, giving the appearance that 
it is doing them simultaneously. 


When a computer has more than one task to perform, some mechanism must be 
provided for deciding which task should be handled at any given instant. In 
the Chroma, there are two tasks, one controlling the synthesizer and one 
responding to commands from the interface. Deciding which task should be 
performed is simple. If a byte is available from the interface, it is pro- 
cessed. If no byte is available, one complete cycle of the synthesizer firm- 
ware is performed (lasting about 1.25msec). 


In order to implement two parallel tasks, it is necessary to save all the 
information representing the state of one task while running the other task. 


5-2 


Chroma Computer Interface Manual Software Requirements 


If a task is suspendable at only one point, and under the same conditions 
every time, no state information is required; the task is nothing more than a 
procedure that is called whenever there is work to do. If the task is to be 
suspendable in more than one place under different conditions, this informa- 
tion must be saved, which usually means using separate stacks. 


The algorithms presented below treat the synthesizer task as the "background" 
task and the external input task as a "priority" task. The synthesizer task 
checks the input queue every now and then and, if a byte is found, causes the 
external input task to be resumed. The external input task is initialized so 
that the arrival of the first byte causes the task to "return" to the begin- 
ning of the command interpreter, which interprets the byte as a command code. 


INTERRUPT DRIVEN DUAL TASK ALGORITHM 


PROCEDURE TO INITIALIZE INTERFACE 
-- called upon start-up 


set input and output queue head and tail pointers to zero 
set non-responding flag -- this gets reset when first byte arrives 
create external input task state image 

-- return address must point into command interpreter, as if 

-~ command interpreter had called input procedure for an op-code 
unmask input interrupt -- output interrupts remain masked 


INPUT AND OUTPUT INTERRUPT HANDLER 
= handles both interrupts until neither is pending 


repeat forever 
if input interrupt pending 
clear non-responding flag 
input byte and put into tail of input queue 
advance input queue tail pointer 
if input queue full 
mask input interrupt 
else if output interrupt pending 
output byte from head of output queue 
advance output queue head pointer 
if output queue empty 
mask output interrupt 
else return from interrupt 


PROCEDURE TO DISPATCH EXTERNAL INPUT PROCESS 
-- called every 1msec or so by the background task 


if input queue not empty 
remove byte from head of input queue 
advance input queue head pointer 
unmask input interrupt -- in case the queue was full 
save background task state 
restore external input task state 
return byte to external input task 
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PROCEDURE TO INPUT ONE BYTE 
=-- called by external input task 


if input queue not empty within 100usec 
remove byte from head of input queue 
advance input queue head pointer 
if input interrupt masked -- meaning queue was full 
unmask input interrupt 
return byte 
else if input queue still empty after 100usec 
save external input task state 
restore background task state 
return to background task 


PROCEDURE TO OUTPUT ONE BYTE 
-- called by either main or external input task 


if non-responding flag set 
discard byte 
else if output queue empty and output port empty within 100usec 
output byte directly 
else if output queue has room in it 
put byte in tail of output queue 
advance output queue tail pointer 
unmask output interrupt -- in case the queue was empty 
else if output queue full 
set non-responding flag 
mask output interrupts 
set input and output queue head and tail pointers to zero 
reinitialize external input task state 


With two hardware-prioritized interrupt lines, the interrupt handler could be 
split in two. Note also that the 100usec waits may actually speed up data 
transfers by increasing the liklihood that a multi-byte data transfer can be 
handled without re-interrupting for each byte. The non-responding flag is a 
mechanism used in the Chroma to handle the case of a crashed computer at the 
other end of the interface. It is cleared by incoming bytes and set if the 
output doesn't respond within a reasonable time. 


Time Measurement -- Computer software to aid in programming the Chroma does 
not require any timing circuitry. However, if you intend to record and play 
back music with the Chroma, time measurement becomes very important. The 
Chroma is pretty good about playing music that arrives over the interface 
without any noticeable time lag. However, if you intend to use an interrupt 
driven input system, you must make sure that the delay between a byte's 
acceptance by the interrupt handler and its ultimate processing doesn't cause 
timing errors in the music. The easiest way to assure this is to let the 
interrupt handler record the time each byte arrives. Each byte in the input 
queue will therefore be accompanied by time information. 


The timing resolution can be fixed, although music processing is easier if all 
events are timestamped according to a metronome that counts in some 
subdivision of the beat such as 48 ticks per beat. The obvious way to do this 
is to use a variable rate hardware timer, but these suffer from the 
disadvantage that they cost money and have less resolution at high speeds than 
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at low speeds. 


The easier way to keep variable-rate time is to use a fixed rate interrupt 
(many computers already have one built in) running at something faster than 
the fastest metronome speed, and then use a phase-increment algorithm to 
determine the actual software metronome rate. This is done by using a 16-bit 
integer and a 16-bit fraction for the metronome, and using a 16-bit fractional 
increment to set the metronome time. On every timer interrupt, the increment 
fraction is added to the metronome fraction. When a carry results, the inte- 
ger part of the metronome is incremented. Thus, the rate at which the integer 
counts is directly proportional to the fractional increment, not inversely 
proportional as is the case with programmable hardware dividers. 


Once the information is pulled from the queve for processing, the time bytes 
associated with command operands can be eliminated, leaving only the time 
bytes associated with each command code byte. The absolute time measurements 
might also be converted to relative time between events, if that is more 
appropriate to the processing that is to be performed. 


Utilizing The Command Language Of The Chroma -- The structure of a music 
recording and playback system is further impacted by the fact that the commun- 
ication in each direction upon the interface is independent, yet the informa- 
tion flowing in each direction is not. To clarify, consider the case of the 
Performance Switch Off command. This command is normally sent to the Chroma 
as a signal that you are finished recording and no more information is to be 
accepted. But it is entirely possible, given the amount of buffering that the 
information must suffer, that further performance information will be trans- 
mitted in the milliseconds after this command has been issued. Even though 
the Chroma does in fact stop transmitting when it sees the Performance Switch 
Off command, there is no guarantee as to how long this will take. The diffi- 
culty is handled by the fact that all such mode change commands are echoed by 
the Chroma. Thus, the stream of data coming back from the Chroma will include 
"flags" that frame the information so that the computer knows when the Chroma 
is done transmitting. The correct way to start and stop recording from the 
Chroma is to keep a status flag that is set by receipt of a Performance Switch 
On command and cleared by receipt of a Performance Switch Off command. When 
recording is to commence or terminate, the computer should send the appropri- 
ate command, but the state of the status flag, controlled by the echoed 
commands, should start and stop the actual recording process. 


The Restore command is actually the command most likely to be used to termin- 
ate recording. This command is provided as a convenience, making it unneces- 
sary to explicitly restore the instrument definitions that were in effect when 
the recording started. Note, though, that the first few Chromas built do not 
echo the Performance, Panel and Pressure Switch Off commands when the Restore 
command is received, but current Chromas do. Refer to Appendix A. 


When recording, with the panel, performance and/or pressure switches on, the 
Chroma will transmit "commands" with instrument codes 0 and 1. In order to 
allow playing and recording at the same time, instruments that are used for 
playback should be assigned higher numbers. If the interface is sending 
commands to instruments 0 and 1, there is nothing to prevent the performance 
controls and panel controls to send commands to these instruments at the same 
time. This shouldn't cause a problem, but it won't sound very good either. 
Note that the commands that are sent by the Chroma during recording are all in 


5-5 


NX 


Chroma Computer Interface Manual Software Requirements 


exactly the form (except for instrument number) that they should be trans- 
mitted back to the Chroma during playback. No other information will be sent 
by the Chroma unless it is explicitly requested. 
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HARDWARE REQUIREMENTS 


This section describes the circuits needed to interface a computer to a 
Chroma. It is assumed that the reader is reasonably familiar with the bus 
structure of his own computer, and what is shown here will have to be modified 
accordingly. In particular, details of address decoding, bus acknowledge and 
interrupt control are not shown. 


Minimal Interface -- At the very least, one must have an 8-bit latch driving 
the output lines that can be written into, an 8=-bit tri-state driver sensing 
the input lines that can be read from, and a set/reset flip-flop associated 
with the output lines that maintains the status of the output port. (The 
other end of the interface maintains the status of the input port.) In 
addition, there must be a way of sensing the status of the two ports. This is 
shown in Fig. 5-1. 


It is assumed here that the bus cycle strobe, read and write signals and 
address are all decoded to provide individual active-low strobes to all cir- 
cuits that require them, that acknowledgement is taken care of elsewhere (no 
wait states should be needed), and that the data bus is an 8=-bit positive 
logic bus. 


The bus drivers shown here are LS TTL devices, as they are probably the 
cheapest kind. For better noise immunity, HCT series CMOS can be used for the 
outputs.' CMOS devices should never be used for inputs, though, as CMOS gates 
are prone to damage when connected to the outside world. 


The XIACK (External Input Acknowledge) and XOFULL (External Output Full) lines 
are driven through transistors so that these outputs will not be pulled down 
when the computer is turned off. Without these transistors, turning off the 
computer would continuously interrupt the Chroma. Since these outputs are 
open collectors, the corresponding inputs XOACK (External Output Acknowledge) 
and XIFULL (External Input Full) lines must be resistor terminated. 


Interrupt Driven System -- The status of each port can be used to generate an 
interrupt. The input port should be capable of generating an interrupt when 
it is full, and the output port should be capable of generating an interrupt 
when it is empty. In addition, each interrupt should be independently mask- 
able. If a multi-level interrupt structure already exists in your system, you 
will only need to connect the status lines (inverting one of them) to two 
interrupt lines. Otherwise, a 2=-bit output port must be provided to hold the 
interrupt mask bits, and some gates must be provided to combine everything 
into one interrupt line. This is shown in Fig. 5-2. The circuit shown 
maintains the interrupt until the condition causing it is removed. Some sys- 
tems will require an open collector interrupt signal. 


Connecting to the Chroma -- The physical interconnection to the Chroma is 
through the 25-pin D-type connector on its rear panel. Figure 5-3 shows the 
pin-out of the connector. Note, however that the names of the connections 
shown in this diagram are from the Chroma's point of view. That is, the lines 
that are associated with the "output" port deal with information flowing out 
of the Chroma, and the lines that are associated with the "input" port deal 
with information flowing into the Chroma, 
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Obviously, the Chroma's output lines must connect to the computer's input 
lines and vice versa. There are two ways to do this. The preferred approach 
is to use a "crossover" cable that connects the XO lines at one end to the XI 
lines at the other end. This guarantees that all devices that have Chroma 
Interfaces have the same pinout, and can be connected with one kind of cable. 
Rhodes sells a sturdy shielded crossover cable, with molded plugs at each end, 
that was designed for this purpose. 


If you wish to use an inexpensive off-the-shelf ribbon cable, you must assign 
pin numbers at the computer's end of the interface according to the scheme in 
figure 5-4. This will connect the XO lines at one end to the XI lines at the 
other, If you choose this approach, you will have created a second "sex" of 
device, possibly causing confusion if you have more than two devices using the 
Chroma Interface. 
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Note: All resistors 100 ohn, 
all capacitors 0.01 uf, unless 
otherwise specified. 
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Fig. 5-1 Minimal Interface 
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Fig. 5-2 Interrupt Driven Interface 
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Note: This pinout should be used at the computer's end of 
the interface, along with the "crossover" type cable. 


Fig. 5-3 Chroma D-connector Pin-out 
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Note: This pinout may be used at the computer's end if 
an off-the-shelf ribbon cable is to be used. See text. 


Fig. 5-4 Complementary Pin-out 
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APPENDIX A 
REVISION INFORMATION 
This section outlines the differences in behavior between instruments of 
different revisions. The Interface Revision Number is returned in response to 
the Identification command. Please note that in the Chroma and Expander this 


number is not the same as the Software Revision Number as imprinted on the 
EPROMs inside the unit. 


The revision levels are described in reverse order, starting with the current 
revision. Each revision description outlines the differences between that 
revision and the subsequent revision above it. 


CHROMA AND EXPANDER REVISIONS 


REV 3 (software REV 13) -- This is the current revision, as described in this 
manual. 


REV 2 (software REV 12) -- This revision did not include the pressure sensor 
commands, This results in the following restrictions: 


The Pressure Switch Off and Pressure Switch On commands are treated as No 
Operations. They are not echoed. 


The Restore Command does not echo a Pressure Switch Off command. 


The pressure byte in all Attack commands sent by the Chroma is 0. The 
pressure byte in all Attack commands received oy | the Chroma is ignored 
(although it must be present). 


A bug was found in this revision: 


If a link is in effect and a lever or pedal is moved, the Chroma will not 
transmit an instrument 0 and an instrument 1 command. Instead, the Chroma 
will send two identical instrument 0 commands. This only applies to the 
Lever 0, Lever 1, Pedal 0 and Pedal 1 commands. 


REV 1 (Software REV 10) -~ A number of bugs were found in this revision: 


If a Footswitch command is sent to any instrument that has never been 
defined since power-up, it will crash the Chroma. 


The Restore command does not do anything to instrument 1, regardless of 
the link. 


Bytes coming from the Chroma occasionally get rearranged and are trans- 
mitted out of sequence. This only occurrs if the computer makes the 
Chroma wait more than 100usec or so, and the Chroma starts to use its 
output queue. If you experience problems at high data rates, suspect 
this. 
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Although the Restore command turns off the panel and performance switch, 
it does not echo the Panel and Performance Switch Off commands. 


Upgrading A Chroma -~- All it takes to bring a Chroma up to the current 
revision is to unplug the EPROMs and plug in new ones. This can be done by 
any authorized Rhodes Chroma service center, and is free if the instrument is 
under warranty. Upgrading is strongly recommended, as old software is only 
old because there was something wrong with it. 


To request an upgrade from a service center, always refer to the Software 
Revision Number which is printed on the EPROMs, not the Interface Revision 
Number. Most service centers are not aware of Interface Revision Numbers. 


The current revision of the Chroma includes provision for the Pressure Sensor 
option. This does not mean that the Pressure Sensor must be installed. The 


Chroma will respond to Pressure commands whether or not the option is in- 
stalled. It just won't generate correct Pressure commands. 


POLARIS REVISIONS 


As of Rev 8, none of the Polaris revisions specifically affected its Chroma 
Interface. 
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A Chroma program consists of 101 parameters divided into four categories: 


Panel Parameters -- These are parameters 0 and 51 through 55, and include 
the parameters that represent the states of various panel controls. These 
are described in detail below. 


Control Parameters -- These are parameters 1 through 5, and are accessible 
from the panel using switches 1 through 5. 


A Channel Parameters -- These are parameters 6 througl: 50, and are access- 
ible from the panel using switches 6 through 50 in Edit A mode. 


B Channel Parameters -- These are parameters 56 through 100, and are 
accessible from the panel using switches 6 through 50 in Edit B mode. 


The Control, A Channel and B Channel Parameters are fully described in the 
Chroma Programming Manual. Their values appear in signed two's complement 
form over the interface. 


The Panel Parameters stored in programs 1 through 50 have no effect, even if 
an instrument is defined by the program. The only Panel Parameters that have 
any effect are those in program 0, and they represent the current states of 
the "programmable" panel controls: 


Q. Link Balance -- This is what appears in the Data Readout when a link is 
set up, although the values are different. The value shown in the display 
ranges from -14 to +14 in steps of 2, while the value accessible through 
the interface ranges from ~-7 to +7 in steps of 1. 


51, Link -- This parameter includes the Link Mode and the Link Program 
Number ina single byte value. The six lsbs represent the Link Program 
Number, which must be between 1 and 50. The two msbs represent the Link 
Mode as follows: 


0 = No Link, 1 = Link Upper, 2 = Link Lower, 3 = Link Unison 
52. Edit -- This parameter includes the Edit Mode and the currently sel- 
ected parameter number. The six lsbs represent the parameter number, 
which must be 0 if the Link Balance parameter is selected, or a number 
from 1 to 50 if a Control or Channel parameter is selected. The two msbs 
represent the Edit Mode as follows: 

1 = Edit B, 2 = Edit A, 3 = Edit A&B 


53. Keyboard Split -- This is a number from -32 to +31. 


Chroma Computer Interface Manual Parameter Information 


54, 55. Main, Link Transposes -- These represent the settings of the 


transpose switches as follows: 
0 = Normal, 1 = Up 1 Oct, 2 = Down 1 Oct 


A Chroma program consists of all the parameter values packed into 59 bytes, 
subdivided as follows: 


Bytes O through 28 contain primarily A Channel Parameters. Some of the 
lower locations within this range are used for Control and Panel 
Parameters, though. 


Byte 29 contains the Sequence Program Number. This is not accessible as a 
parameter. 


Bytes 30 through 59 contain primarily B Channel Parameters in the same 
arrangement as the A Channel Parameters within Bytes 0 through 28. Some 
of the lower locations within this range are used for Control and Panel 
Parameters, though. 


The following table shows the range of each parameter, its scratch value and 
its location within the program. The location of the lsb of the parameter is 
specified in the form "byte:bit". No parameter crosses a byte boundary. For 
instance, the Detune parameter lsb is in byte 2 bit 3 and takes five bits, so 
its msb is in byte 2 bit 7. 


CHROMA PARAMETER LIST 
No(s) Group ___ Name __=_=_==_=_=_==_sSss Range . Scratch Location(s) Length 
0 Panel Link Balance -8..+7 0 31:0 4 
1 Control Patch 0..15 0 1:0 4 
2 Control Fsw Mode O.<T 0 530 3 
3 Control Kybd Alg 0..15 0 31:4 4 
4 Control Detune 06+31 0 2:3 5 
5 Control Output Select 0.3 0 2:1 2 
6/56 Glide Rate 0..31 0 28/5833 5 
7/57 Glide Shape 0..1 0 14/44 36 1 
8/58 Sweep Mode | 0.3 0 4/34:0 2 
9/59 Sweep Rate 0..63 0 4/34:2 6 
10/60 Sweep Rate Mod 0..15 0 3/33:0 4 
11/61 Sweep Wave Shape 0..15 0 6/36 :4 4 
12/62 Sweep Ampl Mod 0..15 0 6/36:0 4 
13/63 Env 1 Ampl Touch 0..7 0 9/39:0 3 
14/64 Env 1 Attack 0..31 0 7/3733 5 
15/65 Env 1 Attack Mod OnsT 0 7/37 :0 3 
16/66 Env 1 Decay 0..31 31 8/38:3 5 
17/67 . Env» 1 Decay Mod 0007 0 8/38:0 3 
18/68 Env 1 Release 0..31 0 9/3933 5 
19/69 Env 2 Delay 0.231 0 10/4033 5 
20/70 Env 2 Ampl Touch Ons 0 13/4330 3 
21/71 Env 2 Attack Owe sit 0 11/4133 5 
22/72 Env 2 Attack Mod Ove 0 11/4130 3 
23/73 Env 2 Decay 0.31 31 12/4233 5 
24/74 ~Env 2 Decay Mod O57 0 12/42:0 3 
25/75 Env 2 Release Oi 31 0 13/4333 5 
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No(s) Group ___ Name ___=_______ss Range Seratch Location(s) Lenrth 

26/76 Pitch Tune 06563 12 14/744:0 6 
27/77 Pitch Mod 1 Select 0.615 0 - 18/484 4 
28/78 Pitch Mod 1 Depth -64..+63 0 15/45:0 . 
29/79 Pitch Mod 2 Select 0..15 0 18/48:0 4 
30/80 Pitch Mod 2 Depth -64..+63 0 16/46 :0 7 
31/81 Pitch Mod 3 Select 0..15 0 19/4934 4 
32/82 Pitch Mod 3 Depth -64..+63 0 17/47:0 4 
33/83 Width Wave Shape O6.02 0 20/50:0 2 
34/84 Width Width 0..63 0 20/50:2 6 
35/85 Width Mod Select 0..15 0 19/49:0 4 
36/86 Width Mod Depth -64..+63 0 21/51:0 7 
37/87 Cutoff LP/HP Oat 0 15/45:7 1 
38/88 Cutoff Resonance One? 0 10/40:0 3 
39/89 Cutoff Tune 0..63 63 22/52:0 6 
40/90 Cutoff Moc 1 Select 0.615 0 26/56 :4 4 
41/91 Cutoff Mod 1 Depth -64..+63 0 23/53:0 7 
42/92 Cutoff Mod 2 Select 0..15 — 0 26/56 :0 4 
43/93 Cutoff Mod 2 Depth -64..+63 0 24/54:0 7 
44/94 Cutoff Mod 3 Select 06.15 0 27/5734 4 
45/95 Cutoff Mod 3 Depth -64..+63 0 25/55:0 | 
46/96 Volume Mod 1 Select 0 A 0 27/57:2 2 
47/97 Volume Mod 1 Depth Ouat5 15 3/33:4 4 
48/98 Volume Mod 2 Select O.03 0 27/57:0 2 
49/99 Volume Mod 2 Depth 0..15 15 5/3534 4 
50/100 Volume Mod 3 Select Osc7 0 28/58:0 3 
51 Panel Link 0..3111..50 0:0 8 
52 Panel Edit Ved 30:0 8 
53 Panel Keyboard Split -32..+31 32:0 8 
54 Panel Main Transpose 0..2 1:6 2 
55 Panel Link Transpose Occ2 1:4 2 
Sequence Program Number 16650 29:0 8 
(Unused bits) 2:0 1 
533 1 
35:0 4 
14/44:7 1 
16/46:7 1 
17/47:7 1 
21/51:7 1 
22/52:6 2 
23/53:7 1 
24/54:7 1 
25/553T 1 

Note -- Signed parameter values are represented in two's complement format 


with the leftmost bit assigned to the parameter being the sign bit. Thus, 
a mod depth of -10 would appear in seven bits as 1110110. 


Chroma Computer Interface Manual Parameter Information 


POLARIS PARAMETERS AND PROGRAM LAYOUT 


A Polaris program consists of 50 parameters divided into two categories: 


Tonal Parameters -- These are parameters 0 through 43, and represent the 
settings of the programming controls that directly affect the sound. They 
are fully described in the Polaris manual. Their values appear in signed 
two's complement form over the interface. 


Panel Parameters -- These are parameters 44 through 49, and represent the 
states of various controls that have no direct effect on the sound. The 
panel parameters are: 


44, Pedal Initial -- When a program is manually selected, this value 
initializes the pedal input to the Main (and possibly the Link) 
Instrument. Changing this through the Chroma Interface has no direct 
effect. 


45. Slider Assignment -- This determines which parameter the 
Assignable Slider is connected to. 


46. Link Mode -- When a program is manually selected, the link mode is 
set according to this as follows: 


0 = No Link, 1 = Link Upper, 2 = Link Lower, 3 = Link Unison 
Changing this through the Chroma Interface has no direct effect. 


47. Link Program Number -- When a program is manually selected and the 
Link Mode is non-zero, this determines which program to link to. 
Program Ai is represented by 1, and program K12 is represented by 132. 
Changing this through the Chroma Interface has no direct effect. 


48, Keyboard Split -- When a Link Upper or Link Lower is in effect, 
the value of this parameter in the Main Instrument determines where 
the keyboard is split. 


49, Keyboard Range -- If this parameter is 1 in the Main Instrument, 
the keyboard notes going to the Main Instrument are transposed up an 
octave. If this parameter is 1 in the Link Instrument, the keyboard 
notes going to the Link Instrument are transposed up an octave. These 
have no effect on notes played through the Chroma Interface. 


Note -- The Transpose and Keyboard Split parameters number the keys from 0 
to 60, rather than -24 to +36 as in the Attack and Release commands. 


The following table shows the range of each parameter, its scratch value and 
its location within the program. The location of the lsb of the parameter is 
specified in the form "byte:bit". Unlike the parameters in a Chroma Program, 
though, these parameters may cross byte boundaries. For instance, the Vibrato 
Pedal parameter has four bits and starts in byte 4 bit 7. This means that the 
next bit is in byte 5 bit 0, the next is in byte 5 bit 1 and the msb is in 
byte 5 bit 2. 
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VOLUME 

GLIDE 

Sweep RATE 

Sweep RATE PEDAL 

Sweep SHAPE 

VIBRATO DELAY 

MOD LEVER RANGE 
VIBRATO PEDAL 

BEND LEVER RANGE 

PITCH PEDAL 

Envelope FIXED/TOUCH 
Envelope ATTACK 
Envelope DECAY 
Envelope SUSTAIN 
Envelope SUSTAIN DECAY 
Envelope RELEASE 
Volume Envelope FIXED/TOUCH 
Volume Envelope ATTACK 
Volume Envelope DECAY 
Volume Envelope RELEASE 
Oscillator 1 TRANSPOSE 
Oscillator 2 TRANSPOSE 
OSC 1 VIBRATO 

OSC 2 VIBRATO 


OSC 2 ENV 

DETUNE 

RING MOD 

SYNC 

Oscillator 1 SAWS/PULSE 
Oscillator 2 SAWS/PULSE 
Oscillator 1 PULSE WIDTH 
Oscillator 2 PULSE WIDTH 
Oscillator 1 SWP PWM/ENV PWM 
Oscillator 2 SWP PWM/ENV PWM 
Oscillator 1 PULSE WIDTH MOD 
Oscillator 2 PULSE WIDTH MOD 


NOISE 

Filter CUTOFF 
Filter RESONANCE 
Filter SWEEP DEPTH 
Filter ENV DEPTH 
Filter KYBD TRACK 
CUTOFF PEDAL 
VOLUME PEDAL 
(Unused bits) 
Pedal Initial 
Slider Assignment 
Link Mode 

Link Program Number 
Keyboard Split 
Keyboard Range 


0..255 
0. .63 
0... 127 
-64..+63 
0..1 
0..63 
0..15 
0..15 
-16..415 
-16..4+15 
Oval 
0.2.63 
0..63 
0..63 
0..63 
0..63 
0..1 
0..63 
0..63 
0..63 
0..60 
0..60 
-64..+63 
-64. .+63 
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-64. .+63 
Oneal 
O.04 
0.561 
Ois:6T 
-64..+63 
-64..+63 
Ose 
One 
-64..4+63 
-64..+63 
heist 
04 «127 
05.7 
-64. .+63 
-64..+63 
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-64..+63 
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0..13 
0..3 
1.2122 
0..60 
0..1 
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APPENDIX C 
USEFUL LOCATIONS WITHIN THE CHROMA 


The memory address space within the Chroma is accessible through the use of 
the Peek, Peek Two Bytes, Poke and Poke Two Bytes commands. Although the 
usefulness of these commands depends upon an understanding of the internal 
structure of the Chroma firmware, there are some locations within the Chroma's 
address space that can be manipulated without really knowing what goes on 
inside the instrument. A few of these are documented here as an aid to anyone 
who wishes to experiment with them. 


Revisions often involve rearranging the locations of things inside the com- 
puter's address space. The only thing that are likely to move, though, are 
those items contained in volatile RAM between locations 0100 and OFFF. 


Once you issue the Unlock command and start Poking into the Chroma, you have 
the capability of crashing the Chroma's computer. A crashed Chroma must be 
powered down and up again to restart it. It is possible that a crash may 
corrupt the programs stored in non-volatile RAM (possibly only a byte here and 
there), Therefore, the 50 programs should be reloaded via cassette (or via 
the interface) in the event of a crash. 


Be sure to use the Peek Two Bytes and Poke Two Bytes commands whenever you are 
accessing a two byte value. This insures that the interface's access to the 
locations does not get interleaved with the Chroma's access to the same loca- 
tions. 


0020-0029: Display image -- This contains the image of the ten display 
digits. Changes made to the first eight locations (the Data Readout) only 
last until some action occurs on the panel that involves the display. 
Changes made to the last two locations (the Program Number) last until a 
program is selected or stored. 


002A: LED image byte 1 -- This contains the image of those eight LEDs that 
are capable of being flashed. Writing to this location will cause the 
appropriate LEDs to change state, as this location is copied to the LED 
port byte 1 at regular intervals. 


002B: LED image byte 2 -- This contains the image of those eight LEDs that 
never flash. Writing to this location does not make the LEDs change 
state, so the LED port byte 2 should be written as well. 


002C: LED blink image -- This byte is XORed with the LED image byte 1 at 
regular intervals to cause LEDs to flash. This should normally be set 
whenever the image byte is set. 


0048, 0049: Master tune -- This two-byte number contains the master tune 
setting for the instrument. Whenever the tune slider is moved, this will 
be set to an even number between -256 and +246, which represents a range 
from -1 to almost +1 semitones. As long as the master tune slider is not 
moved, this location canbe played with through the interface. 
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005A, O005B: Safe buffer program number, modified flag -- This conteins 
information about the contents of the safe buffer. Whenever 2 program is 
selected or stored, the safe buffer is used to store a backup copy of 
whatever is written over. 


006A, 006B: Major loop hook -- Every 20 milliseconds or so, an indirect 
subroutine call is made through this location. Normally, this contains 
C100, the address of a Return instruction, 


006C, 006D: Minor loop hook -- Every 1.25 milliseconds or so, an indirect 
subroutine call is made through this location. Normally, this contains 
C100, the address of a Return instruction, 


0140-017A: Safe buffer -- Whenever a program is selected or stored, what- 
ever is written over is first copied here. 


017B-01BE: Stack -- The stack grows from high memory to low, and we have 
never seen it go below 0190, so that leaves twenty locations that are 
probably free. Assign from 017B up, to be safe. 


O1BF-O2BF: Cassette buffer -- These 257 bytes are where each packet is 
stored as it is read from or written to the tape. Although it is possible 
to have a packet that fills the buffer, the packets used in ordinary 
cassette operations never exceed sixty bytes, so locations 01FB to 02BF 
are generally free. Assign from O02BF down, to be safe. Note: In REV 1 
and 2, the cassette buffer is located in OBFF to OCFF. 


1000 to 13FF: Empty -- These locations correspond to the two empty chip 


' locations on the computer board. 


1400 to 1FCO: Programs -- The 51 programs (0 to 50) are packed into this 
area, Each program occupies 59 bytes, 


1FC1 to 1FFO: Free non-volatile memory -- These 48 locations are not 
currently used. Assign from 1FC1 up, to be safe. 


1PP1: Cassette type -- If bit 2 of this byte is set, normal cassette motor 
sense/control functions are enabled. If bit 2 is clear, the cassette 
moter is ignored. 


1FF2: Program number -- The current program number, as shown in the dis- 
play, is kept here, 


1FF3: Modified flag -- The modified flag appears in bit 7 of this byte. 
The other bits must be zero. 


1FFC: Attack threshold -- General modulation selection 13 (Threshold Velo- 
oity) and Ampl Touch settings 6 and 7 compare the velocity of each attack 
to this number, which must be between 0 and 31. 


1FFD: Release threshold -=- Envelope Release setting 31 causes each release 
velooity to be compared to this number, which must be between © and 31. 


C2 
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1FFE: Release slow value -- Envelope Release setting 31 causes this number 
to be used as the release parameter for releases slow than the above 
threshold. It should be between 0 and 31. 


1FFF: Release fast value -- Envelope Release setting 31 causes this number 
to be used as the release parameter for releases faster than the above 
threshold. It should be between 0 and 31. 


2006: LED port byte 1 -- This write-only location directly controls those 
eight LEDs that are capable of flashing. This location should not be 
directly referenced, as it is automatically rewritten from the LED image 
byte 1 at regular intervals. 


2007: LED port byte 2 -- This write-only location directly controls those 
eight LEDs that never flash. When this location is written, the LED image 
byte 2 should also be written. 


C100: Return -- This location contains a Return instruction. Software 
hook cells should always contain C100 when not in use. 


C-3 
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APPELDIZ D 
POLARIS OBJECTS AND STREAMS 


The Polaris supports a set of Chroma Interface commands that allows objects 
inside the Polaris to be created, deleted, opened, read, written, and added to 
the system as software extensions. It also allows messages in the Polaris' 
internal message format (which bears no resemblance to the Chrome Irterface 
language) to be inserted into the various internal data streams. Certain of 
these functions requires knowledge of proprietary details of the inner worke- 
ings of the Polaris; if misused, the Polaris' computer will almost definitely 
crash, and in doing so will probably clobber ea few bytes in the middle of your 
favorite program or sequence. In other words, experiment at your own risk. 
Other functions, though, are documented here, as they are fairly simple anc 
presumed to be generally useful. 


The Chroma Interface allows an external computer to gain access to one inter- 
nal data object at a time. At any given time, one object (possibly non- 
existent) is "open" to the interface, and this object (if it exists) is either 
write-enabled or write-protected. Objects that are write-protected can be 
read with Peek and Peek Two Bytes. Objects that are write-enabled can also be 
written with Poke and Poke Two Bytes. Each object, then, is like a separate 
address space of a particular size, and accesses beyond the end of an object 
are prevented, 


All objects are numbered using a 16-bit number, and the particular association 
between object numbers and particular physical objects is instrument- 
dependent. That is, future instruments that use this interface will probably 


have different object numbers, It is, however, possible to find out if an 
object exists and how big it is through the interface. 


Polaris Object Numbers 
The following objects can be safely created, deleted, open, read and written: 


0001..0084 -=- Programs Al, A2, 43, ..., K11, K12. Each of these must be 
44 bytes long if it exists. 


0094..009F -- Sequences 1 through 12. 
The following objects can be safely open and read. 


0000 -- The entire RAM space. When the instrument is turned on, this is 
open and write-protected. 


0085 -- The Main Instrument (Instrument 0). The first 44 bytes of an 
instrument contain the program that controls its sound. 


0066 -=- The Link Instrument (Instrument 1). This normally only exists if 
a link is set up. 
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0087 -- The Sequencer Instrument (Instrument 2). This normally only 
exists while a sequence is being played. 


0088..008C -- Instruments 3 through 7. These normally only exist if they 
have been created through the Chroma or MIDI interface. 


Polaris Data Stream Numbers and Messages 


Internally, the Polaris encodes events as messages, and these messages flow in 
streams between the different parts of the internal software. These messages 
look completely different from the commands in the Chroma Interface language; 
most notably, they are all two bytes long (not including an instrument number, 
if any). Some messages allow things to be done that could not otherwise be 
done through the Chroma Interface language. The Chroma Interface language 
therefore provides a mechanism for inserting messages into the internal 
streams. 


In general, if you send a message to a stream that goes someplace, and the 
message is not understood, the message will be ignored. If, however, you send 
a message to a stream that doesn't go someplace, the computer will crash. The 
following stream numbers (in hex) can be safely used: 


16: Panel -- This is where the panel sends switch press and slider mes- 
sages. It understands the following messages and operands: 


OC ss -- Switch Press 
Switch ss is pressed, where ss is in the range 01..3B. The 
switches are numbered basically from left to right. 


ss pp -=- Slider Move 
Slider ss - 80, where ss is in the range 81..93 (the slider number 
is in the range 01..13) is moved to position pp (00 is bottom, FF 
is top). The sliders are numbered from left to right, not includ- 
ing the Master slider. 


17: Master -- This is where the panel sends Master slider messages. It 
only understands: 


80 pp -- Master Slider Move 
The master slider is moved to position pp (00 is bottom, FF is 
top). The effect of this depends upon the current function of the 
master slider. 


1E: Instrument -- A message sent here will be played by the logical in- 
strument, if it exists. An instrument number (00..07) must be specified. 
Some of the messages understood by instruments are: 


7D pp -= Swap Program 
The program contained in the instrument is swapped with program pp 
(where pp is in the range 01..84). 


7D FF -- Release Instrument 
All notes are released. 
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No Operation 00 

Identification 01 01 device revision 
Read Program 02 prog 02 data 
Write Program 03 prog data59 

Load Packet (C) O4 04 n data® 
Save Packet (C) 05 n datan 05 result 
Read Parameter 06 prog param 06 value 
Write Parameter O7 prog param value 

Panel Switch Off 08 08 

Panel Switch On 09 09 
Performance Switch Off OA OA 
Performance Switch On OB OB 

Peek OC addr2 OC n data” 
Peek Two Bytes OD addr2 OD data2 
Poke OE addr2 n data® 

Poke Two Bytes OF addr2 data2 

Tap Panel (C) 10 

Unlock/Lock (C) 11 00 FF / 11x x 

Tape Space (C) 12 12 result 
Restore 13 08 OA 14 
Pressure Switch Off 14 14 
Pressure Switch On 15 15 

Tune Get: (P) 16 16 tuning 
Tune Set (P) 17 tuning 

Open Object (P) 18 object2 mode 18 length? 
Create Object (P) 19 object2 length2 mode 

Delete Object (P) 1A 

Add Extension (P) 1B 

Send Message (P) 1C stream instr message operand 

Get LED (P) 1D led 1D state 
Pressure 68+i key pressure 

Information T0+i 70+i boards 0 0 0 
Volume 78+i volume 

Lever 1 80+i position 

Lever 2 88+i position 

Pedal 1 90+i position 

Pedal 2 98+i position 

Footswitch 1 Down AO+i 

Footswitch 1 Up A8+i 

Footswitch 2 Down BO+i 

Footswitch 2 Up B8+i 

Define CO+i prog 11 12 p1 p2 vol fsw 
Undefine C8+i 

Attack DO+i key velocity pressure 

Release D8+i key velocity 

Set Parameter E0+i param value 

Status E8+i E8+i prog 11 12 p1 p2 vol fsw 
Squelch FO+i key 


A superscript denotes a byte count. (C) means supported only by the Chroma 
and Expander. (P) means supported only by the Polaris. 


E=-1 


